home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / wc3x / postmstr.zip / POSTMSTR.DOC next >
Text File  |  1992-03-29  |  12KB  |  310 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                            Post Master Version 1.0
  11.  
  12.                     -= For Wildcat! 3.XX systems only =-
  13.  
  14.          Copyright (c) 1992 Boardwalk Software - All Rights Reserved.
  15.  
  16.                  Technical Support and the latest versions!
  17.  
  18.                    The Boardwalk!  (206) 941-3124  (DATA)
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  Post Master - An automatic message sending program for Wildcat! BBS systems.
  30.  ─────────────────────────────────────────────────────────────────────────────
  31.  
  32.  
  33.   Disclaimer
  34.  
  35.   Boardwalk Software hereby disclaims all warranties relating to this product,
  36.   whether express or implied, including without limitation any implied
  37.   warranties of merchantability or fitness for a particular purpose. Boardwalk
  38.   Software cannot and will not be liable for any special, incidental,
  39.   consequential, indirect or similar damages due to loss of data or any other
  40.   reason, even if Boardwalk Software or an authorized Boardwalk Software agent
  41.   has been advised of the possibility of such damages.  In no event shall the
  42.   liability for any damages ever exceed the price paid for the license to use
  43.   software, regardless of the form and/or extent of the claim.  The user of
  44.   this program bears all risk as to the quality and performance of the software.
  45.  
  46.   Copyright
  47.  
  48.   Regardless of the method of marketing used, Post Master is NOT in the
  49.   "Public Domain".  It is copyrighted by Dave Cody and Boardwalk Software.
  50.  
  51.   License
  52.  
  53.   Post Master is a Shareware product.  As such, it is made available to the
  54.   general computing public for evaluation.  Users are licensed to operate Post
  55.   Master on their personal computers for the purpose of test and evaluation on
  56.   a trial basis for a limited trial period.  It is not possible to reasonably
  57.   define any definitive limits of a fair and equitable time period for
  58.   evaluation, therefore, it is left to the user's decision as to its
  59.   usefulness.  If the user decides the program is not of sufficient merit to
  60.   warrant purchase through registration with Boardwalk Software, the program
  61.   should be removed from their personal computer.  Otherwise, if the program
  62.   is deemed useful and is in regular use on the user's personal computer
  63.   system, registration with Boardwalk Software is required.
  64.  
  65.   Registration
  66.  
  67.   You may register Post Master by sending the enclosed REGISTER.FRM along with
  68.   a check in the amount of $20.00 to Dave Cody at the address listed below:
  69.  
  70.  
  71.                                 Dave Cody
  72.                                 P.O. Box 99948
  73.                                 Tacoma, WA 98499
  74.  
  75.  
  76.   Technical Support
  77.  
  78.   Comments and suggestions about Post Master are welcome as well as any
  79.   comments or suggestions that you may have in terms of additional utilities
  80.   you would like to see written.  Please call The Boardwalk! at (206) 941-3124.
  81.   I can also be reached via Fidonet at 343/47 and Mustang Software Support BBS.
  82.  
  83.  
  84.  
  85.  Post Master - An automatic message sending program for Wildcat! BBS systems.
  86.  ─────────────────────────────────────────────────────────────────────────────
  87.  
  88.  
  89.   Operation
  90.  
  91.   Post Master is fairly straight forward and most of the information you need
  92.   to run the program is in the help screen you can view by running the program
  93.   with no parameters or with /?.  The point of the program is the ability to
  94.   send one message to one or more callers from the DOS command line.  You
  95.   start by creating a text file or use one created for you by another program.
  96.   Using any of the available command line parameters you can send this message
  97.   to callers by name, security level, or using a merge file created by a
  98.   program like WCPRO.  Post Master will add the message(s) to the database
  99.   very quickly.  I have included some examples and suggested uses towards the
  100.   end of this documentation.  Post Master MUST be run from the same directory
  101.   as Makewild and Wildcat!, i.e. the Wildcat! HOME directory.
  102.  
  103.   Multi-Node
  104.  
  105.   If you run a multi-node system you can safely use Post Master while other
  106.   nodes are running since Post Master uses the same file locking routines as
  107.   used by Wildcat!.  However, Post Master requires the %wcnodeid% environment
  108.   variable to be set.
  109.  
  110.   Feature List
  111.  
  112.   ■  Send one message to one or more callers
  113.  
  114.   ■  Will use a merge list or allow you to specify a security level
  115.  
  116.   ■  Automatically maintain the high message setting in the conference
  117.  
  118.   ■  Checks and uses the conference settings for allow private, force private,
  119.      allow return receipt, allow attachments.
  120.  
  121.   ■  Allows messages to flagged for private, return receipt, and attachments
  122.  
  123.   ■  Purges message of all control characters below #32
  124.  
  125.   ■  Sets the mail waiting flag for callers to whom the message is sent
  126.  
  127.   ■  Truncates message lines at 79 characters - does not word wrap.
  128.  
  129.   ■  Import a text file directly or an IMP file in the message database dir
  130.  
  131.  
  132.  
  133.  Post Master - An automatic message sending program for Wildcat! BBS systems.
  134.  ─────────────────────────────────────────────────────────────────────────────
  135.  
  136.  
  137.   Command line switches
  138.  
  139.   Case is not important but each option must be separated by a space.
  140.  
  141.   /I:<text file>
  142.  
  143.   This is the only required switch.  All of the others have defaults or are
  144.   not necessary to the functionality of the program.  The import file must be
  145.   an ASCii text file and can be in the current directory or you may specify
  146.   the name and path to it on the command line.  Post Master will read the file
  147.   and extract control characters like the page feed and bell characters.  If
  148.   this filename has an extension of "IMP" Post Master will simply add the line
  149.   <<filename.imp to the message.  It will not test for the existance of this
  150.   import file, it is your responsibility to place the file in the proper
  151.   message subdirectory.  If you use the IMP feature do not specify a path.
  152.  
  153.   /C:<conference number>  DEFAULT = 0
  154.  
  155.   Post Master will send messages to any established conference.  It defaults
  156.   to conference 0 as does Wildcat! itself, but it will NOT create a conference
  157.   database if one does not already exist.
  158.  
  159.   /M:<merge file>
  160.  
  161.   The merge file is a list of names you want the message sent to.  This list
  162.   can be created with a number of programs, but must be an ASCii text file and
  163.   must have one name only on each line of the file.  ie:
  164.  
  165.   DONALD DUCK
  166.   BUGS BUNNY
  167.   PORKY PIG
  168.  
  169.   Post Master will read the merge file one line at a time and send a duplicate
  170.   message to each of the callers listed.
  171.  
  172.   /L:<security level>
  173.  
  174.   This parameter can be used to send a message to all callers matching
  175.   security level.
  176.  
  177.   /T:<message to>  DEFAULT = ALL
  178.  
  179.   Use this parameter to send a message to one caller, for instance, yourself.
  180.   This persons name does not need to be in the Wildcat! User database so you
  181.   can use Post Master to send messages via ECHOmail conferences, but be
  182.   careful to follow the Networks rules in this area.
  183.  
  184.   /F:<message from>  DEFAULT = SYSOP'S NAME
  185.  
  186.   Use this parameter to specify the sender of the message.  This caller does
  187.   not need to exist in your Wildcat! User database so that you can use it to
  188.   send message from "Post Master" for instance.
  189.  
  190.  
  191.  Post Master - An automatic message sending program for Wildcat! BBS systems.
  192.  ─────────────────────────────────────────────────────────────────────────────
  193.  
  194.  
  195.   /S:<message subject>  DEFAULT = Message from Post Master
  196.  
  197.   Use this parameter to change the default message subject.
  198.  
  199.   /P
  200.  
  201.   Use this parameter to change the message to a private message.  This will be
  202.   overridden by any conference specific parameter you might have set.
  203.  
  204.   /R
  205.  
  206.   Use this parameter to toggle the return receipt flag.  This will be
  207.   overridden by any conference specific parameter you might have set.
  208.  
  209.   /O
  210.  
  211.   This toggle will cause Post Master to ignore the conference settings for
  212.   allowing private messages, return receipts, and file attachments.
  213.  
  214.   /A:<attached file>
  215.  
  216.   Place a file in the appropriate attachment directory and specify the file
  217.   name here and all callers that receive this message will be told there is a
  218.   file attached.  Post Master will NOT verify the existance of the file.
  219.  
  220.   /X   [Registered version only]
  221.  
  222.   Disable's the Post Master tag line to allow messages to keep that personal
  223.   touch.
  224.  
  225.   /Z:<program name>
  226.  
  227.   If for any reason you wish to change the name of the executable file to
  228.   something else you will need to run Post Master with this parameter once
  229.   after the name change.  You might want to change the name to PM.EXE, so you
  230.   would use the DOS rename command to do this and then run: PM /Z:PM.EXE
  231.  
  232.  
  233.  
  234.  Post Master - An automatic message sending program for Wildcat! BBS systems.
  235.  ─────────────────────────────────────────────────────────────────────────────
  236.  
  237.  
  238.   Suggested uses
  239.  
  240.   Some of the uses I have discovered or have been told of for Post Master are:
  241.  
  242.   ■ Send a message to yourself from your new user questionnaire
  243.  
  244.     POSTMSTR /i:c:\wc30\ques\quesnew.001 /t:your name /f:post master /p
  245.  
  246.   ■ Send the output of your nightly mail run to yourself
  247.  
  248.     POSTMSTR /i:c:\robo\robocomm.log /t:your name /f:post master /p
  249.  
  250.   ■ Send a mass mailing to all "MEMBERS" about new features of you BBS
  251.  
  252.     POSTMSTR /i:member.msg /f:your name /m:member.lst /p  (by list)
  253.      or
  254.     POSTMSTR /i:member.msg /f:your name /l:member /p  (by security level)
  255.  
  256.   ■ Send a newuser letter to all new users with a membership letter and
  257.     registration file attached and a receipt back to you that they read it.
  258.  
  259.     POSTMSTR /i:welcome.imp /a:member.zip /p /r /s:Welcome the The Boardwalk!
  260.  
  261.   ■ Update registered users of a companys software of an update
  262.  
  263.     POSTMSTR /i:update.txt /m:register.lst /p /s:Release of version 2.0!
  264.  
  265.  
  266.   There are many more possibilities for you to discover.  Have fun!
  267.  
  268.  
  269.  
  270.  Post Master - An automatic message sending program for Wildcat! BBS systems.
  271.  ─────────────────────────────────────────────────────────────────────────────
  272.  
  273.  
  274.   Acknowledgements
  275.  
  276.   Post Master was written in Turbo Pascal v6.0 from Borland International with
  277.   additional help from Turbo Power Software in the use of their outstanding
  278.   Btree Filer and Object Professional libraries for Turbo Pascal.  I would
  279.   also like to thank MSI since none of this would have been possible without
  280.   them and their excellent bulletin board program, Wildcat!.  And lastly, Gwen
  281.   Barnes who came up with the original idea for the program.
  282.  
  283.   Thanks!
  284.  
  285.  
  286.   Other programs by Boardwalk Software
  287.  
  288.   Purge       - Purge your activity log of local and Sysop logons.
  289.  
  290.   Lopper      - "Lop" off your activity log based on a number of days.
  291.  
  292.   WCToday     - Bulletin/Hello maker listing all of todays callers.
  293.  
  294.   MWExport    - Export your Makewild settings to a text file for printing
  295.  
  296.   SLS         - Sort your Wildcat! 3.0 security levels after adding one
  297.  
  298.   Addfiles    - Add files to Wildcat! 3.0 from a RoboComm files.bbs list
  299.  
  300.  
  301.   Authenticity Verification
  302.  
  303.   This archive has been zipped using Boardwalk Software's authenticity
  304.   verification number from PKWare.  If there are any files in the archive that
  305.   do not have the verification tag beside them it indicates that the archive
  306.   has been tampered with and is not in it's original form.  If this is the
  307.   case, please call the support bbs - The Boardwalk! - and get a clean copy.
  308.  
  309.  
  310.